package com.eet.jpa.service;

import com.eet.jpa.entity.member.User;
import org.springframework.data.domain.Example;
import org.springframework.data.domain.Page;
import org.springframework.data.repository.query.Param;

import java.util.List;
import java.util.Map;

/**
 * 用户服务类
 *
 * @author Administrator
 */
public interface UserService {

    /**
     * 根据ID查找
     *
     * @param id 主键ID
     * @return 用户信息
     */
    User findById(int id);

    /**
     * 保存用户信息
     *
     * @param user 用户信息
     * @return 是否成功
     */
    boolean saveUser(User user);

    /**
     * 分页数据
     *
     * @param pageNo   当前页
     * @param pageSize 每页数量
     * @return 分页数据信息
     */
    Page<User> page(int pageNo, int pageSize);

    /**
     * 批量保存用户
     *
     * @param users 用户列表
     */
    void saveUsers(List<User> users);

    /**
     * 通过邮件查询用户信息
     *
     * @param email 邮件信息价
     * @return 用户信息
     */
    List<User> findByEmail(String email);

    /**
     * 通过邮件和电话查询用户信息
     *
     * @param email 邮件
     * @param phone 电话
     * @return 用户信息
     */
    List<User> findByEmailAndPhone(String email, String phone);

    /**
     * 通过角色查询用户信息
     *
     * @param roleName 角色ID
     * @return 用户信息
     */
    List<Map<String, Object>> findByRole(@Param("roleName") String roleName);

    /**
     * 按例查询（QBE）是一种用户界面友好的查询技术。 它允许动态创建查询，并且不需要编写包含字段名称的查询。
     * 实际上，按示例查询不需要使用特定的数据库的查询语言来编写查询语句。
     * <p>
     * Example api的组成
     * Probe: 含有对应字段的实例对象。
     * ExampleMatcher：ExampleMatcher携带有关如何匹配特定字段的详细信息，相当于匹配条件。
     * Example：由Probe和ExampleMatcher组成，用于查询。
     * 限制
     * 属性不支持嵌套或者分组约束，比如这样的查询 firstname = ?0 or (firstname = ?1 and lastname = ?2)
     * 灵活匹配只支持字符串类型，其他类型只支持精确匹配
     *
     * @param example QBE实例对象
     * @return 用户信息集合
     */
    List<User> findByExample(Example<User> example);
}
